Customer Top Up

Berfungsi untuk melakukan top up dengan cara memindahkan saldo id penampungan ke user

Service Info

HTTP Method	POST
Service Code	38
Http Method	POST
Path	.../{version}/emoney/topup

Header

Header Name	Tipe Data	Wajib	Deskripsi
Content-Type	String	Y	application/json
Authorization	String	Y	Token B2B
Authorization-Customer	String	Y	Token B2B2C
X-SIGNATURE	String	Y	Dibuat dengan algoritma asymmetric with token B2B2C: Signature Generation
X-PARTNER-ID	String	Y	Client’s client_id (diberikan pada saat onboarding )
X-EXTERNAL-ID	String	Y	Nomor referensi yang harus unik pada hari yg sama
CHANNEL-ID	String	Y	00001 untuk PJP and 00002 untuk non PJP

Body

Parameter	Tipe Data	Wajib	Deskripsi
partnerReferenceNo	String	Y	Pengidentifikasi transaksi pada sistem konsumen layanan Length : <= 64 karakter
customerNumber	String	Y	Nomor bank tujuan yang akan di topup Length: <= 16 karakter
amount	Object	Y	Informasi tambahan
value	String	Y	Nominal yang akan di deposit
currency	String	Y	Kode mata uang Length: 3 Allowed Value: IDR
notes	String	N	Catatan Length: <= 255 karakter
additionalInfo	Object	Y	Informasi tambahan
centralId	String	Y	Id master Key

Request samples

JSON

{
    "partnerReferenceNo": "51251241241",
    "customerNumber": "0812xxxxxxxx",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "notes": "topup driver",
    "additionalInfo": {
        "centralId": "xxxxxx"
    }
}

CURL

curl --location --request POST '.../v1.0/emoney/topup' \
--header 'X-TIMESTAMP: 2023-01-24T10:57:00+07:00' \
--header 'X-SIGNATURE: RwABEherf+3MTBhIf6vtju6ko+YOFFKWLGgHCD5RwX1I17JCKVn8ffc/TenEIly85InhuIcKCDqDrxbIBhaKEg==' \
--header 'X-PARTNER-ID: 085224a9-4b42-4f7d-959f-4452f8a9a1ff' \
--header 'X-EXTERNAL-ID: 72f6eea0-7ca6-4409-b544-b9cf9d4bb014' \
--header 'X-DEVICE-ID: android-20013adf6cdd8123f' \
--header 'CHANNEL-ID: 12345' \
--header 'Authorization: Bearer bb005fcb-dea9-499a-9e7a-bcf651b2334e' \
--header 'Authorization-Customer:Bearer 5b8bbaf8-4aca-4072-9ea8-d85bed65105f' \
--header 'Content-Type: application/json' \
--data '{
    "partnerReferenceNo": "51251241241",
    "customerNumber": "0812xxxxxxxx",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "notes": "topup driver",
    "additionalInfo": {
        "centralId": "xxxxxx"
    }
}'

Response Structure

Parameter	Tipe Data	Deskripsi
responseCode	String	Kode respons Length: <= 7 karakter
responseMessage	String	Deskripsi respons Length: <= 150 karakter
referenceNo	String	Kode Transaksi Lenght: <= 64 karakter
additionalInfo	Object	Informasi Tambahan
description	String	Informasi Tambahan
destinationId	String	Nomor tujuan Lenght: <= 16 karakter

Response samples

{
    "responseCode": "2003800",
    "responseMessage": "Successful",
    "referenceNo": "5329575",
    "additionalInfo": {
        "description": "Transaksi Berhasil. Anda telah mengirim dana ke ID 0812xxxxxxxx sejumlah Rp 10.000-. Saldo Anda Rp 214.500-.",
        "destinationId": "0812xxxxxxxx"
    }
}

List Response Code API Customer Top Up

Response Code	Response Message	Description
2003800	Success	Sukses
4003801	Invalid field format { field name }	Format invalid
4003802	Invalid mandatory field {field name}	Format pada bidang wajib tidak ada atau tidak valid
4013800	Unauthorized. Invalid Signature	X-Signature salah
4093800	Cannot use same X-EXTERNAL-ID in same day	X-External-ID sudah pernah digunakan di hari yang sama
4043801	Bad Request	Request header ada yang salah / kurang
4043801	Unauthorized. Client Forbidden Access API	Partner tidak dapat mengakses api terkait